Inside Macintosh: Telephony /

Chapter 1 - Introduction to Telephony on the Macintosh / Telephone Manager Initialization Reference

Telephone Manager Initialization Functions / Configuring a Telephone Tool Through a Custom Interface

TELSetupPreflight

Returns a handle to a dialog item list generated by the telephone tool that you can append to your custom tool-settings dialog box.

pascal Handle TELSetupPreflight (short procID, long *magicCookie);

procID

The tool ID for the telephone tool that is being configured.

magicCookie

On exit, a pointer to a reserved area of memory used by the telephone tool to pass relevant dialog items and configuration settings. This value should be passed to the other functions used to set up the custom tool-settings dialog box.

function result

A handle to a dialog item list. You use the handle returned by TELSetupPreflight for the theDITL parameter specified through AppendDITL that you use to append the list to your custom tool-settings dialog box.

DESCRIPTION

The TELSetupPreflight function returns, as its function result, a handle to the basic dialog elements for a particular telephone tool. You can use the handle generated by the telephone tool (which is not the same as a resource handle) to append the dialog item list to your custom tool-settings dialog box. The list is stored in a reserved area of memory specified by the magicCookie pointer. To append the list, you can use the AppendDITL function described in Inside Macintosh: Macintosh Toolbox Essentials. After you have accessed the relevant information, you are responsible for disposing of the handle associated with the dialog item list.

Note

The refCon field of your custom tool-settings dialog box should point to a data structure where the first two bytes identify the tool ID and the next four bytes point to the area reserved for magicCookie.